package com.zenithmind.exam.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.zenithmind.exam.pojo.entity.ExamStatistics;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.math.BigDecimal;
import java.util.List;

/**
 * 考试统计Mapper接口
 * 
 * @author ZenithMind
 * @since 2024-07-01
 */
@Mapper
public interface ExamStatisticsMapper extends BaseMapper<ExamStatistics> {

    /**
     * 根据考试ID查询统计信息
     * 
     * @param examId 考试ID
     * @return 统计信息
     */
    @Select("SELECT * FROM exam_statistics WHERE exam_id = #{examId}")
    ExamStatistics selectByExamId(@Param("examId") String examId);

    /**
     * 查询热门考试统计（按参与人数排序）
     * 
     * @param limit 限制数量
     * @return 热门考试统计列表
     */
    @Select("SELECT * FROM exam_statistics ORDER BY total_participants DESC LIMIT #{limit}")
    List<ExamStatistics> selectHotExamStatistics(@Param("limit") Integer limit);

    /**
     * 查询高通过率考试统计
     * 
     * @param minPassRate 最低通过率
     * @param limit 限制数量
     * @return 高通过率考试统计列表
     */
    @Select("SELECT * FROM exam_statistics WHERE pass_rate >= #{minPassRate} ORDER BY pass_rate DESC LIMIT #{limit}")
    List<ExamStatistics> selectHighPassRateExams(@Param("minPassRate") BigDecimal minPassRate, @Param("limit") Integer limit);

    /**
     * 查询低通过率考试统计（需要关注的考试）
     * 
     * @param maxPassRate 最高通过率
     * @param limit 限制数量
     * @return 低通过率考试统计列表
     */
    @Select("SELECT * FROM exam_statistics WHERE pass_rate <= #{maxPassRate} AND submitted_count > 0 ORDER BY pass_rate ASC LIMIT #{limit}")
    List<ExamStatistics> selectLowPassRateExams(@Param("maxPassRate") BigDecimal maxPassRate, @Param("limit") Integer limit);

    /**
     * 统计总体数据
     * 
     * @return 总体统计信息
     */
    ExamStatistics selectOverallStatistics();

    /**
     * 根据分数范围统计考试数量
     * 
     * @param minAvgScore 最低平均分
     * @param maxAvgScore 最高平均分
     * @return 考试数量
     */
    @Select("SELECT COUNT(*) FROM exam_statistics WHERE avg_score BETWEEN #{minAvgScore} AND #{maxAvgScore}")
    Integer countByAvgScoreRange(@Param("minAvgScore") BigDecimal minAvgScore, @Param("maxAvgScore") BigDecimal maxAvgScore);

    /**
     * 查询最近更新的统计信息
     * 
     * @param limit 限制数量
     * @return 最近更新的统计信息列表
     */
    @Select("SELECT * FROM exam_statistics ORDER BY update_time DESC LIMIT #{limit}")
    List<ExamStatistics> selectRecentUpdated(@Param("limit") Integer limit);

    /**
     * 统计各分数段的考试数量
     * 
     * @return 分数段统计
     */
    List<ExamStatistics> selectScoreRangeStatistics();

    /**
     * 查询需要更新统计的考试
     * 
     * @return 需要更新统计的考试ID列表
     */
    @Select("SELECT DISTINCT er.exam_id FROM exam_record er " +
            "LEFT JOIN exam_statistics es ON er.exam_id = es.exam_id " +
            "WHERE er.status IN (2, 3) AND (es.exam_id IS NULL OR er.update_time > es.update_time)")
    List<String> selectExamsNeedStatisticsUpdate();
}
